home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / circuits / pcb-1.000 / pcb-1 / pcb-1.3 / README_FILES / INSTALL next >
Text File  |  1995-02-19  |  5KB  |  149 lines
  1.  
  2.                             COPYRIGHT
  3.  
  4.   PCB, interactive printed circuit board design
  5.   Copyright (C) 1994, 1995 Thomas Nau
  6.  
  7.   This program is free software; you can redistribute it and/or modify
  8.   it under the terms of the GNU General Public License as published by
  9.   the Free Software Foundation; either version 2 of the License, or
  10.   (at your option) any later version.
  11.  
  12.   This program is distributed in the hope that it will be useful,
  13.   but WITHOUT ANY WARRANTY; without even the implied warranty of
  14.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15.   GNU General Public License for more details.
  16.  
  17.   You should have received a copy of the GNU General Public License
  18.   along with this program; if not, write to the Free Software
  19.   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20.  
  21.   Contact addresses for paper mail and Email:
  22.   Thomas Nau, Schlehenweg 15, 88471 Baustetten, Germany
  23.   Thomas.Nau@rz.uni-ulm.de
  24.  
  25.  
  26.  
  27. -----------------------------------------------------------------------------
  28.  
  29. The release has been successfully compiled on the following platforms:
  30.  
  31. X11R4
  32.     Check the GNU info file for problems.
  33.     The dynamic offset for printouts is not supported because of the
  34.     missing panner widget.
  35.  
  36. HP series 300 (9.00), 700 (9.0[13]) and 800 (9.0[04])
  37.     All HP machines require the MIT release of X11R5 (or R6 of the
  38.     XConsortium). HP does not ship the Athena Widgets with its release nor
  39.     necessary tools like imake...
  40.     You will also have to get yourself an ANSI compiler if you are stuck
  41.     with HPs cc.
  42.  
  43. Sun Sparc (Solaris 2.3, BSD 4.1.3)
  44.     You won't have any problems if you use X11R5 or later. 
  45.     Using OpenWindows will cause some of them. See the GNU info file for
  46.     details about it.
  47.  
  48. Silicon Graphics Indigo (IRIX 4.0.5)
  49.     No problems beside additional CFLAGS in Imakefile. Check if you are
  50.     using a R4 server and, if you do, read the GNU info file of pcb.
  51.  
  52. Linux 0.99pl14 and later, XFree 2.1.1 and later
  53.     No problems.
  54.  
  55. SCO ODT 3.0
  56.     Needs tls003 of the Athena Widget library from sosco.sco.com
  57.     (mailed by John DuBois <spcecdt@deeptht.armory.com>).
  58.  
  59. FreeBSD
  60. NetBSD
  61.     Get latest version of bison and flex as a replacement for yacc and lex.
  62.  
  63. -----------------------------------------------------------------------------
  64.  
  65.      ***** YOU MUST HAVE AN ANSI COMPILER TO COMPILE THESE SOURCES *****
  66.  
  67. Here's how to install:
  68.  
  69. 1. Edit Imakefile:
  70.    - define the installation path for fonts...
  71.    - if your architecture isn't listed, define
  72.        EXITCALL as:
  73.          -DHAS_ATEXIT if your system supports atexit()
  74.          -DHAS_ON_EXIT if your system supports on_exit()
  75.          or none of them if the OS doesn't support it
  76.        SYS_LIBRARIES as
  77.          -ll (for lex) plus -lm
  78.          -lfl (for flex) plus -lm
  79.        PATCHES as
  80.          -DNEED_STRDUP if your system does not have strdup()
  81.      add some additional defines as needed. If it works ok mail a copy to
  82.      the author to be included in the next (sub)release.
  83.  
  84. 2. Run 'xmkmf -a' to create the Makefile or if you don't have it
  85.      imake -DUseInstalled -I<X11 config directory>
  86.      make Makefile
  87.      make includes
  88.      make depend
  89.    Don't care about warnings at this time.
  90.  
  91. 3. Run 
  92.        make pcb.man
  93.        make Pcb.ad
  94.        make pcb.info
  95.        make pcb.dvi
  96.        make refcard.ps
  97.    to create a man page, the application default resource file, a GNU
  98.    info file as well as a TeX documentation. The last line creates a
  99.    reference card for your configuration. Manuals for the default
  100.    configuration as well as texinfo.tex can be found in ../doc
  101.  
  102. 4. Get yourself a printed copy of the documentation and of the 'Pcb.ad'.
  103.    Read 'Whats_new*' to see if old file have to be updated.
  104.  
  105. 5. Run 'make' to build the program, it's manpage and the resource file
  106.    if they haven't been build in step (3).
  107.  
  108. 6. Test the program before you install it to see if the application defaults
  109.    match your window environment. Copy 'Pcb.ad' to your home directory or
  110.    to the one where your environment 'XAPPLRESDIR' points to and rename it
  111.    to 'Pcb'.
  112.    Set the resource:
  113.        .pcb.elementPath:    .:./circuits:./packages
  114.  
  115. 7. Take the printed copies from (2) and check if the translations work
  116.    (see chapter 'Getting Started') by running 'pcb example/68HC11'.
  117.    It comes up with 68HC11 microcontroller layout.
  118.  
  119.    Take special care on the resources related to functions keys and the
  120.    pointer buttons because most of the window managers use them too.
  121.    Change 'Pcb.ad.raw' according to your hardware/software environment.
  122.    You may have to change all occurances of 'baseTranslations' to
  123.    'translations' in your resource file if you use X11R4.
  124.  
  125.    You have to get newer versions of yacc/lex (bison/flex) if the
  126.    program fails parsing the default font or the demo file.
  127.  
  128. 8. When you're satisfied with the defaults and the program run:
  129.        make install
  130.        make install.man
  131.        make install.info
  132.    as a user with the appropriate rights. Depending on the filemodes set
  133.    by your X11 environment you must remove existing copies of fonts,
  134.    manpage and program before you are able to install successfully.
  135.    Set umask to 022 else the new created directories wont be world
  136.    readable; the fonts cannot be found.
  137.  
  138. 9. Join the info mailing list by sending mail to
  139.        pcb-request@pluto.medizin.uni-ulm.de
  140.  
  141.  
  142. If yout create any element files or package description files I would be glad
  143. to get a copy to include them into the next release or an additional archive.
  144.  
  145.  
  146. Have fun with it.
  147.  
  148. Thomas
  149.